PATHMac OS 8 and 9 Developer Documentation > Human Interface Toolbox > Window Manager >

Programming With the Mac OS 8.5 Window Manager


IsWindowPathSelectClick

Reports whether a mouse click should activate the window path pop-up menu.

pascal Boolean IsWindowPathSelectClick (
                     WindowPtr window,
                     EventRecord *event);
window
A value of type WindowPtr . Pass a pointer to the window in which the mouse-down event occurred.
event
A pointer to a value of type EventRecord . Pass a pointer to the EventRecord structure containing the mouse-down event that IsWindowPathSelectClick is to examine.
function result
A value of type Boolean . The function returns true if the mouse click should activate the window path pop-up menu; otherwise, false .
DISCUSSION

The Mac OS 8.5 Window Manager provides system support for your application to display window path pop-up menus--like those used in Finder windows. When the user presses the Command key and clicks on the window's title, the window displays a pop-up menu containing a standard file system path, informing the user of the location of the document displayed in the window and allowing the user to open windows for folders along the path.

Because the window title includes both the proxy icon region and part of the drag region of the window, your application must be prepared to respond to a click in either region by displaying a window path pop-up menu. Therefore, when the FindWindow function returns either the inDrag or the inProxyIcon result code--you should pass the event to the IsWindowPathSelectClick function to determine whether the mouse-down event should activate the window path pop-up menu. If IsWindowPathSelectClick returns a value of true , your application should then call the function WindowPathSelect to display the menu. Listing 2-5 in Displaying a Window Path Pop-Up Menu shows how your application might handle a user request to display the window path pop-up menu.

VERSION NOTES

Available with Mac OS 8.5 and later.


© 1999 Apple Computer, Inc. – (Last Updated 18 March 99)